home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr31 / compr16.zip / COMPR16.DOC next >
Text File  |  1993-05-11  |  12KB  |  305 lines
  1.     -----------------------------------------------------------------
  2.     compr16.zip - last modified Sat Aug 26 15:43:49 1989 PDT
  3.     -----------------------------------------------------------------
  4.     V1.6 contents: xt.com - fr.com - vw.com - mr.com - compr16.doc
  5.  
  6.     Differences from version 1.5 are barred - Mark B. Foster
  7.  
  8.     -----------------------------------------------------------------
  9.     Introduction.
  10.     -----------------------------------------------------------------
  11.     This archive contains four extremely fast utilities that simplify
  12.     the routine chores of extracting from, freshening, and viewing
  13.     file lists in compressed files:
  14.  
  15.         xt - extractor for zip, lzh, pak, arc, zoo, dwc, md, lzs
  16.              files
  17.         fr - freshener for zip, lzh, pak, arc, zoo, dwc, lzs files
  18.         vw - file lister for zip, lzh, pak, arc, zoo, dwc, md, lzs
  19.              files
  20.     |    mr - pipe for use with vw
  21.  
  22.     The utilities were assembled using a86 v3.21.  Special thanks to
  23.     Eric Isaacson for suggestions on optimizing the code.
  24.  
  25.     -----------------------------------------------------------------
  26.     Program syntax.
  27.     -----------------------------------------------------------------
  28.     Xt usage: xt [-o -u] archive [filename{s}]
  29.  
  30.         -o  overwrite existing output files
  31.         -u  unlink (delete) archive(s) after file extraction
  32.  
  33.     -----------------------------------------------------------------
  34.     Fr usage: fr [-c -s] archive [filename{s}]
  35.  
  36.     |    -c  set pak v2.x to use Crush for true-pak files
  37.     |        set pkzip v0.92 to use Shrink
  38.  
  39.     |    -s  set pkzip v1.01 to use Shrink
  40.     |        set pak to use Squash for arc-format files
  41.  
  42.     | The 'c' switch may be set as the default by changing the byte at
  43.     | debug offset :0279 from 00 to ff.  The 's' switch may be set as
  44.     | the default by changing the byte at offset :0280 from 00 to ff.
  45.  
  46.     -----------------------------------------------------------------
  47.     Vw usage: vw archive [filename{s}]
  48.  
  49.     -----------------------------------------------------------------
  50.     | Mr usage: [cmd seq |] mr [filename]
  51.  
  52.     | The phrase 'cmd seq' signifies a command sequence of the form
  53.     | 'vw *.zip' or 'vw new.pak'
  54.  
  55.     -----------------------------------------------------------------
  56.     General notes for xt, fr, vw.
  57.     -----------------------------------------------------------------
  58.     Archive extensions need not be specified.
  59.  
  60.     DOS wildcards and pathnames are supported.
  61.  
  62.     The '/' switch character may be used instead of '-'.
  63.  
  64.     Only one switch may be set at a time.
  65.  
  66.     The compression programs must be located on the path.
  67.  
  68.     Xt, fr, and vw return a nonzero errorlevel if an they encounter an
  69.     error during execution.
  70.  
  71.     A cryptic usage message may be viewed by entering 'xt', 'fr', or
  72.     'vw' with no parameters at the DOS prompt.
  73.  
  74.     | The version id and usage message may be viewed with the command
  75.     | 'type n' (where 'n' is the utility name) at the DOS prompt.
  76.  
  77.     -----------------------------------------------------------------
  78.     Specific notes for xt, fr, vw.
  79.     -----------------------------------------------------------------
  80.     Each of the tables in this section lists the programs supported by
  81.     the utilities and the switches passed to them.  A dot ('.')
  82.     indicates no arguments.  Blanks denote that an option is not used.
  83.  
  84.     -----------------------------------------------------------------
  85.     Pkzip/unzip notes.
  86.  
  87.     | For pkzip.exe v1.01, fr defaults to Implode; the 's' switch sets
  88.     | pkzip to use Shrink instead.
  89.  
  90.     | For pkzip.exe v0.92, fr defaults to Reduce4; the 'c' switch sets
  91.     | pkzip to use Shrink instead.
  92.  
  93.     +-------+------+----+-------+------+-------+-------+----+
  94.     |  pgm  | vers | xt | xt -o |  fr  | fr -c | fr -s | vw |
  95.     +-------+------+----+-------+------+-------+-------+----+
  96.     |       | 1.01 |    |       |      |       | -fes  |    |
  97.     | pkzip |------|    |       | -fex |-------|-------|    |
  98.     |       | 0.92 |    |       |      |  -f   |       |    |
  99.     +-------+------+----+-------+------+-------+-------+----+
  100.     |pkunzip| both | .  |  -o   |      |       |       | -v |
  101.     +-------+------+----+-------+------+-------+-------+----+
  102.  
  103.     -----------------------------------------------------------------
  104.     Pak notes.
  105.  
  106.     With true-pak files, fr sets pak.exe to use Distill by default.
  107.     The command 'fr -c' sets pak to use Crush instead.
  108.  
  109.     +-------+------+----+-------+----+-------+----+
  110.     |  pgm  | vers | xt | xt -o | fr | fr -c | vw |
  111.     +-------+------+----+-------+----+-------+----+
  112.     |  pak  | 2.10 | e  | e /wa | f  | f /cr | v  |
  113.     +-------+------+----+-------+----+-------+----+
  114.  
  115.     -----------------------------------------------------------------
  116.     Arc-format notes.
  117.  
  118.     | Xt and vw look first for pak.exe, then for pkxarc.exe if pak is
  119.     | not found; fr looks first for pak, then for pkarc.exe.
  120.  
  121.     | If pak is used for arc-format files, fr sets pak to use Crunch
  122.     | by default.  The command 'fr -s' sets pak to use Squash instead.
  123.  
  124.     The utilities are compatible with arc-format files created using
  125.     pre-Crunch compression methods.
  126.  
  127.     Pkpak.exe and pkunpak.exe can be used by renaming them pkarc.exe
  128.     and pkxarc.exe respectively.
  129.  
  130.     +-------+------+----+-------+------+-------+----+
  131.     |  pgm  | vers | xt | xt -o |  fr  | fr -s | vw |
  132.     +-------+------+----+-------+------+-------+----+
  133.     |  pak  | 2.10 | e  | e /wa | f /c | f /s  | v  |
  134.     +-------+------+----+-------+------+-------+----+
  135.     | pkarc | 3.6  |    |       |  -f  |       |    |
  136.     +-------+------+----+-------+------+-------+----+
  137.     |pkxarc | 3.6  | .  |  -r   |      |       |-vv |
  138.     +-------+------+----+-------+------+-------+----+
  139.  
  140.     -----------------------------------------------------------------
  141.     Lharc and larc notes.
  142.  
  143.     | The utilities now parse all lzh files correctly.
  144.  
  145.     | The utilities now support lzs files.
  146.  
  147.     | Xt and vw look first for larc.exe, then for lharc.exe if larc is
  148.     | not found.  Because larc and lharc use different compression
  149.     | methods, fr looks only for larc.
  150.  
  151.     +-------+------+------+-------+----+----+
  152.     |  pgm  | vers |  xt  | xt -o | fr | vw |
  153.     +-------+------+------+-------+----+----+
  154.     | lharc |1.13c | e /c | e /cm | f  | l  |
  155.     +-------+------+------+-------+----+----+
  156.     | larc  | 3.3  | e /c |e /c/o | f  | l  |
  157.     +-------+------+------+-------+----+----+
  158.  
  159.     -----------------------------------------------------------------
  160.     Zoo and looz notes.
  161.  
  162.     | Xt and vw look first for zoo.exe, then for looz.exe if zoo is
  163.     | not found.
  164.  
  165.     Fr first directs zoo to freshen an archive, then to pack it.
  166.  
  167.     The utilities also operate upon bak archives created by zoo.
  168.  
  169.     +-------+------+----+-------+------+----+
  170.     |  pgm  | vers | xt | xt -o |  fr  | vw |
  171.     +-------+------+----+-------+------+----+
  172.     |  zoo  | 2.01 | x  |  xSO  | auP: | l  |
  173.     +-------+------+----+-------+------+----+
  174.     | looz  | 2.1  | x  |       |      | l  |
  175.     +-------+------+----+-------+------+----+
  176.  
  177.     -----------------------------------------------------------------
  178.     Dwc and mdcd notes.
  179.  
  180.     +-------+------+----+-------+----+----+
  181.     |  pgm  | vers | xt | xt -o | fr | vw |
  182.     +-------+------+----+-------+----+----+
  183.     |  dwc  |a5.01 | e  |  ew   | fz | v  |
  184.     +-------+------+----+-------+----+----+
  185.     | mdcd  | 1.0  | d  |   r   |    | l  |
  186.     +-------+------+----+-------+----+----+
  187.  
  188.     -----------------------------------------------------------------
  189.     Specific notes for mr.
  190.     -----------------------------------------------------------------
  191.     | Two versions of mr are included: mr_n.com (for use with the
  192.     | device driver nansi.sys), and mr_a.com (for use with ansi.sys).
  193.     | Mr_n fully exploits nansi's blazingly fast screen control, and
  194.     | is highly recommended.  Nansi.sys is readily available on many
  195.     | BBSs.
  196.  
  197.     | The following discussion assumes one of the two versions has
  198.     | been selected and renamed 'mr.com'.
  199.  
  200.     | Mr is a pipe similar to, but far superior to, the DOS utility
  201.     | 'more'.  It is included here for use with vw to pause the
  202.     | display when viewing long archive file lists.  For example:
  203.  
  204.     |    vw * | mr
  205.  
  206.     |    vw test.zip | mr
  207.  
  208.     |    vw ??.lzh | mr
  209.  
  210.     | Mr may also be used by itself as a simple text-viewing utility.
  211.     | For example:
  212.  
  213.     |    mr compr16.doc
  214.  
  215.     | Although mr accepts DOS pathnames, it does not as yet accept
  216.     | wildcards.
  217.  
  218.     | The following commands may be issued at the '--More--' prompt:
  219.  
  220.     |    'l' line-by-line scroll
  221.     |    'h' half-screen scroll (13 lines)
  222.     |    'f' full-screen scroll (24 lines)
  223.     |    'k' keep screen and quit
  224.     |    'c' clear screen and quit
  225.     |    'm' menu choices
  226.  
  227.     | If 'mr' is entered without arguments, the computer will appear
  228.     | to hang.  Pressing f6 or ctrl-z terminates mr and exits to DOS.
  229.  
  230.     | The mr version id and usage message may be viewed with the
  231.     | command 'type mr.com' at the DOS prompt.
  232.  
  233.     -----------------------------------------------------------------
  234.     Utility history.
  235.     -----------------------------------------------------------------
  236.        xt10  07-05-89  Initial release of xt.com.
  237.  
  238.     -----------------------------------------------------------------
  239.     compr11  07-11-89  Initial release of fr.com and vw.com.
  240.                        Fixed parsing of Squashed true pak files.
  241.                        Added archiver version and switch table to dox.
  242.  
  243.     -----------------------------------------------------------------
  244.     compr12  07-20-89  Added support for pkpak/unpak v3.61.
  245.                        Added fr 'c' and 's' switches.
  246.                        Changed fr pkzip v0.92 default to Reduce4.
  247.  
  248.     -----------------------------------------------------------------
  249.     compr13  07-27-89  Modified error handling and display.
  250.                        Fixed parsing of Packed arc-format files.
  251.  
  252.     -----------------------------------------------------------------
  253.     compr14  08-02-89  Added support for pak v2.x and Distill.
  254.                        Removed support for pkpak/unpak and tau.
  255.                        Added version id.
  256.                        Changed fr true-pak pak default to Distill for
  257.                            v2.x.
  258.                        Added fr 'C' switch.
  259.                        Adjusted fr zoo and looz precedence.
  260.  
  261.     -----------------------------------------------------------------
  262.     compr15  08-12-89  Added support for pkzip/unzip v1.01 and
  263.                            Implode.
  264.                        Added support for all pre-Crunch arc formats.
  265.                        Changed fr pkzip default to Implode for v1.01.
  266.                        Made fr pak v2.x default user-configurable.
  267.                        Added fr 'S' switch.
  268.                        Made fr switch letters user-configurable.
  269.                        Adjusted fr arc-format pak and pkarc/xarc
  270.                            precedence.
  271.                        Optimized utilities for a86 v3.21 assembler.
  272.  
  273.     -----------------------------------------------------------------
  274.     compr16  08-26-89  Initial release of mr.com.
  275.                        Added support for larc v3.3.
  276.                        Concatenated usage message to version id.
  277.                        Fixed parsing of lzh files.
  278.                        Made fr pkzip defaults user-configurable.
  279.                        Changed fr arc-format pak default to Crunch.
  280.                        Merged fr switch letters and operation.
  281.                        Removed fr switch letter configurability.
  282.                        Reversed fr arc-format pak and pkarc/xarc
  283.                            precedence.
  284.                        Adjusted fr zoo and looz precedence.
  285.                        Added history section to dox.
  286.  
  287.     -----------------------------------------------------------------
  288.     Miscellaneous.
  289.     -----------------------------------------------------------------
  290.     If you have renamed any of the supported compression programs or
  291.     want to rename these utilities, I would be happy to recode them
  292.     for you with the new names and upload them.
  293.  
  294.     Feel free to contact me with suggestions or problems.  I receive
  295.     email at the following places.
  296.  
  297.         College Corner: 206/643-0804
  298.         Signpost: 206/547-0167
  299.         CompuServe (ibmpro): 72261,2531
  300.  
  301.     Although xt, fr, vw, and mr have been extensively tested, and all
  302.     known bugs have been squashed, I make no warranty that the
  303.     programs will do anything right.  Any and all risk of using them
  304.     is yours alone.
  305.